---
title: "Configure Odigos with Argo CD"
sidebarTitle: "Odigos with Argo CD"
---

This guide shows you how to deploy Odigos in your Kubernetes cluster using Argo CD with the official Odigos Helm chart. This allows for GitOps-based management and observability instrumentation across your applications.

## Prerequisites

Before you begin, make sure you have:

* A running Kubernetes cluster
* Argo CD installed and configured in the cluster
* Helm CLI installed (optional but useful for inspection and verification)

## Step 1: Add the Odigos Helm Repository

Add the Odigos Helm repository to your Helm configuration:

```bash
helm repo add odigos https://odigos-io.github.io/odigos --force-update
helm repo update
```

## Step 2: Identify the Helm Chart Version

Check available versions of the Odigos chart to determine the desired `targetRevision`:

```bash
helm search repo odigos --versions
```

## Step 3: Define the Argo CD Application Manifest

Create an Argo CD `Application` custom resource to deploy Odigos using Helm. Save the following YAML as `odigos-application.yaml`:
This guide shows you how to deploy Odigos in your Kubernetes cluster using Argo CD with the official Odigos Helm chart. This allows for GitOps-based management and observability instrumentation across your applications.

## Prerequisites

Before you begin, make sure you have:

* A running Kubernetes cluster
* Argo CD installed and configured in the cluster
* Helm CLI installed (optional but useful for inspection and verification)

## Step 1: Add the Odigos Helm Repository

Add the Odigos Helm repository to your Helm configuration:

```bash
helm repo add odigos https://odigos-io.github.io/odigos --force-update
helm repo update
```

## Step 2: Identify the Helm Chart Version

Check available versions of the Odigos chart to determine the desired `targetRevision`:

```bash
helm search repo odigos --versions
```

## Step 3: Define the Argo CD Application Manifest

Create an Argo CD `Application` custom resource to deploy Odigos using Helm. Save the following YAML as `odigos-application.yaml`:

```yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: odigos
  namespace: <ARGOCD_NAMESPACE>  # <- Replace with your Argo CD namespace
spec:
  project: default
  source:
    repoURL: https://odigos-io.github.io/odigos
    chart: odigos
    targetRevision:  # REQUIRED: set the version from 'helm search repo odigos --versions'
    helm:
      releaseName: odigos
      values: |
        # OPTIONAL: add your custom Helm values here if needed.
        # Argo CD expects this field to be a YAML-formatted string.
        # To use chart defaults, delete this field entirely or set it to an empty string ("").
  destination:
    server: https://kubernetes.default.svc
    namespace: <ODIGOS_NAMESPACE>  # <- Replace with the desired namespace where you want Odigos to be installed
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true
```

## Step 4: Apply the Application

Use `kubectl` to create the application in Argo CD:

```bash
kubectl apply -f odigos-application.yaml
```

This will instruct Argo CD to deploy Odigos using the Helm chart.

## Step 5: Monitor the Deployment

You can monitor the status of the deployment through the Argo CD UI:

* Navigate to your Argo CD web interface.
* Find the application named `odigos`.
* Verify that it reaches a **Healthy** and **Synced** state.

Once complete, Odigos will be installed in your cluster and ready to instrument workloads.
